home *** CD-ROM | disk | FTP | other *** search
/ The 640 MEG Shareware Studio 2 / The 640 Meg Shareware Studio CD-ROM Volume II (Data Express)(1993).ISO / door / lgnp9c.zip / 109-READ.ME next >
Text File  |  1992-05-13  |  16KB  |  316 lines

  1.  
  2.  
  3. Date: 05-13-92
  4. Time: 08:25 am
  5.  
  6. from the desk of Lonnie J. Rolland
  7.  
  8. Please find (contained within the zip) the file group for Logger Generic.
  9. Included is a normal and (if you register) tsr version of the data collector.
  10.  
  11. The data is kept in dBase format.  The program can be ran in single or
  12. local area network mode.  Each record has a data field and (up to) 8KB
  13. memo text area. Logger's functions are: add, delete, browse, and search.
  14. Ascii text can be imported into the text area. Output can be sent to the
  15. printer or a text file. Records can be password locked with a word key
  16. so others may not alter them.
  17.  
  18. LOGGER has a ascii text file which is read the first time the executable
  19. is ran. The contents of the small text file configures the mode of
  20. operation you will be running and the names of the different field
  21. labels to a record.
  22.  
  23. The config file is read to obtain the following information:
  24. 1st) the Logger title that sits top center when its envoked.
  25. 2nd) the drive and subdirectory to where the .dbf/.dbt is placed.
  26. 3rd) four groups of numbers that set the four colors! There are 128
  27.      possible color combinations. Run 'config.exe' to check it out.
  28. 4th) configuration parameter letters: a 'm' or a 'c' to force mono or
  29.      color display mode, an 'n' if you want network share locks, a 'd'
  30.      if you want to run in a bbs doorway mode, an 'o' to force open
  31.      records locked with a different lgkey than yours, OR if you want
  32.      to see deleted records and want to undelete them.  So you may put:
  33.      'nothing!' or 'm' or 'c' or 'n' or 'd' or 'o' or 'cn' or 'nd' or...
  34. 5th) would need the path to where 'door.sys' could be found if you use
  35.      the bbs doorway mode.
  36. 6th thru the 13th) are the seven field labels.
  37.  
  38. Run the supplied program 'config9.exe' to make (easy) changes to the
  39. ascii config file. Change the four colors to something you like. After
  40. the colors are right, press <esc> to go on to editing the labels. Press
  41. <esc> to exit the second part and <y>es to save your changes. Its easy.
  42.  
  43.  
  44.  
  45.  
  46. For version 1.09 of Logger, the labels on the upper part of a record has
  47. been slimmed down to only six fields where the operator types in verbage.
  48. Field one & two are under program control. Field one gets assigned a number
  49. at the time the record is written to disk. Field two has todays date auto-
  50. matically put in at the record start. Fields three thru eight typically
  51. ask for name, address and phone number stuff.  You can choose the field
  52. names that will appear there.  But the names you choose DO have a word
  53. length constraint!  The working example supplied with LGNP9 might suit
  54. your particular needs.
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65. Here is its layout below:
  66. ╒══════════════════════════ TESTING OUT THE CHANGES ══════════════════════════╕
  67. │                                                                             │
  68. │  Post It#: 00046            Date Written: 03/01/92                          │
  69. │                                                                             │
  70. │Originator: Lawrence Livermore..  Company: 12345678901234567890              │
  71. │  Phone No: 12345678901234567890   Fax No: 12345678901234567890              │
  72. │   Product: 123456789012345678901234567890                                   │
  73. │                                                                             │
  74. │  Abstract: 1234567890123456789012345678901234567890123456789012345          │
  75. ╞═══════════════════════════════<Text Area>═══════════════════════════════════╡
  76. │11111111111111                                                               │
  77. │2222222222222222222                                                          │
  78. │3333333333333333333333                                                       │
  79. │aaaaaaaaaaaaaaaaaaaaaaaaaaaa                                                 │
  80. │bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb                                          │
  81. │ccccccccccccccccccccccccccccccccccccccccc                                    │
  82. │44444444444444444444444444444444444444444444444444                           │
  83. │555555555555555555555555555555555555555555555555555555555                    │
  84. │666666666666666666666666666666666666666666666666666666666666666666           │
  85. │ddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddd      │
  86. ╞═════════════════════════════════════════════════════════════════════════════╡
  87. │                       Press the <H> key for help.                           │
  88. │        [ESC] exit   Add <   >  SEARCH <   >  Browse <   >                   │
  89. ╘═════════════════════════════════════════════════════════════════════════════╛
  90.  
  91. Look at the third line in the record field.  The third field currently has
  92. 'Originator: ' as a label, which is a twelve character string.  The number
  93. twelve is important. You can put in any twelve ( or less ) character string
  94. you wish in its place.  If you supply it with a string which is bigger,
  95. it'll only use the first twelve characters.  Now lets break away from these
  96. details and back up a bit.
  97.  
  98.  
  99. LoggerG is fully functional, non-crippled information logging program.
  100. It can be used to track clients or cases in a legal office.  It could
  101. track customers in a sales office.  You could use it to post items for
  102. sale or trade.  You could post people and their occupations where the
  103. posted are looking for gainful employment.  In a material control
  104. office, it could keep track of vendors and their promises.  In a
  105. tech support group, you could track customer problems or loaned out
  106. equipment.  The list could go on and on...
  107.  
  108. It uses a DBase III+ compatable .dbf and .dbt
  109.  
  110. *********************************************************************
  111. ***                    ATTENTION USERS                            ***
  112. *** LG can run on a network with full record/file locking,        ***
  113. *** therefore if and when you do so you MUST run dos's SHARE      ***
  114. *** program first before the logger or it'll keep popping up      ***
  115. *** error messages at you and not save your input.                ***
  116. ***                                                               ***
  117. *** The locking is done with dos share calls. Therefore you have  ***
  118. *** to be running DOS version 3.1 or later.                       ***
  119. ***                                                               ***
  120. *** It'll still work fine if you don't have a network too.        ***
  121. ***                                                               ***
  122. *** By default logger doesn't need share and will NOT do locking. ***
  123. *** You turn that mode of operation 'ON' by including a 'N' in    ***
  124. *** the second line of the config file.                           ***
  125. *********************************************************************
  126.  
  127.  
  128. Install and remove the program from your hard disk with the batch
  129. files MAKE_LG and REMO_LG. The make batch file will create a
  130. subdirectory and put an empty data file set in it.
  131.  
  132. To use the program, envoke it with the batch file called LOGGER. It will
  133. change directory, setup an environment variable, and then envoke logger.
  134. Logger auto-detects whether its running on a mono or color system.
  135. If the auto-detect is mis-interpretting your hardware, you can force
  136. color mode by putting a 'C' in line 2 of the config file, or force mono
  137. mode by putting a 'M' there.
  138.  
  139.  
  140. The logger program, when envoked, needs about 118k bytes of ram.
  141. The file 'LG.EXE' is the tsr version of the program. It's a nice, small
  142. 6.5KB pop up tsr that uses swapping technology. The hot key to pop it
  143. up is "CTRL" + "ALT" + "A". Note you have to hold all 3 keys down at the
  144. same time.  The tsr version of logger does not have a doorway mode.
  145. The tsr can un-load itself.  By pressing 'R' at the main menu, logger
  146. will release its (small) captive ram and un-hook itself from the system
  147. interupts.  The file 'LGNP.EXE' is the non resident ( pass through )
  148. version of the program. Both programs look and function exactly alike.
  149. The file 'L3GF-BLK.ZIP' is a set of empty .dbf/.dbt files.
  150.  
  151. Made a small (but very inportant) changes to the no-pop version of
  152. Logger to make it desqview aware. If you're lucky enough to be running
  153. this outstanding program, Logger now gives back about 80% of its
  154. horsepower to the other applications that may be running in your
  155. other DV windows. Wow! It was fairly easy to do.  Most of the time
  156. the program is sitting and waiting for a key press. That wait time
  157. is handed back to the desqview time slice manager.
  158.  
  159. Logger now has a delete function.  While in the 'search' or 'browse'
  160. mode, press the 'D' key.  If you are the owner of the record, you may
  161. mark it deleted. In multi-user and doorway mode, there can be many
  162. different people adding records.  In doorway mode the program reads
  163. the 'door.sys' file and generates a record 'key'.  In multi-user mode,
  164. each person must set a dos environment variable called 'LGKEY' to a
  165. made up password.  What LGKEY is set to becomes the record password.
  166. Then nobody else can make changes to your records.
  167.  
  168. A note about 'Orphaned Memos'.
  169. They will happen within the .dbt file when you: 1) delete and pack out
  170. the .dbf that points to the memo, 2) edit an existing memo and make it grow
  171. larger in size than it originally was (512 to 1024, 1024 to 1536...etc).
  172.  
  173. Please find the program called 'LG9PACK.EXE'. It's purpose is to pack out
  174. the 'Orphaned Memos'. It walks down through the .dbf and rebuilds the .dbt
  175. file as it goes. It does not use network locks, ergo pack your data local.
  176.  
  177.  
  178. The structure for L3GF.DBF is:
  179. Field  Field Name  Type       Width    Dec       (label)    (length)
  180.     1  FN01        Character      5           { post-it        10 }
  181.     2  FN02        Character      8           { date written   14 }
  182.     3  FN03        Character     20           { originator     12 }
  183.     4  FN04        Character     20           { company         9 }
  184.     5  FN05        Character     20           { phone no       10 }
  185.     6  FN06        Character     20           { fax no          8 }
  186.     7  FN07        Character     30           { product         9 }
  187.     8  FN08        Character     55           { abstract       10 }
  188.     9  FN17        Character     40           {                   }
  189.    10  MEMOFLD     Memo          10
  190. ** Total **                     229
  191.  
  192.  
  193. Previous versions of Logger had timers, find, browse, choose from multible
  194. database sets and did time accumulation and date stamping.  This current
  195. version of logger has only add, search, browse, and date stamping.  It has
  196. less functionality and complexity.
  197.  
  198. Logger will now also send the currently displayed record to the
  199. printer too. If you are within the find or browse function, you
  200. press the (P) key to send the record information 'out' to the printer.
  201.  
  202. Logger will produce an ascii output file too.  From the main program
  203. prompt, press the (T) key.  It will ask you from which record to
  204. begin with.  Then it will walk from that record to the end and transfer
  205. the data to an ascii file (with labels) called 'DATALOG.TXT'.
  206.  
  207. The add (A) command starts an entry.
  208.  
  209. The search (S) command is my personal favorite.
  210. It (currently) works on seven fields of the record.  A search can
  211. act upon the 1st, 2nd, 3rd, 4th, 7th, 8th, and MEMO field.  I skipped
  212. (for now) the 5th and 6th (phone number) fields.  The search builds
  213. a scrollable pick list with one line representing one record.  Pressing
  214. 'enter' will pop that record up for a full view.  Next key press takes
  215. you right back to the pick list.  If you want to go from pick list
  216. right to editing the selected record, press 'ctrl-enter'.
  217. The search order is from the last record to the first record. It will
  218. find embedded strings anywhere within the target string and is case
  219. insensitive.
  220.  
  221. The browse (B) command uses the keypad keys. It uses the
  222. up, down, PgUp, PgDn, home, and end key.  If numlock is on, it will use
  223. the 7, 8, 9, 1, 2, 3's keys also.  Browse will remember where
  224. you were browsing at last.
  225.  
  226. You may start an addition then escape out to save or throw the record
  227. away.  If you elect to edit a record from the search or browse mode,
  228. you do so by pressing 'enter' in browse or 'ctrl-enter' in search mode.
  229. When you have finished your editing, logger will ask you if you want to
  230. (maintainence mode) re-write the record back to where it came from OR
  231. (add mode) append the record as a new one to the end of the DBF.
  232.  
  233. The memo text area portion saves only what it needs to save, from a
  234. 512 byte minimum, to a 8192 byte maximum size. The full screen editor
  235. understands wordstar style key strokes and it does automatic
  236. word-wrap at the end of lines also!
  237.  
  238. There is an un-delete function added. I went about it this way.
  239. If you have added the 'O' parameter to the param line of the config
  240. file, you are in super user mode. You get to see and un-delete the
  241. deleted records while in browse mode. The 'O' param still keeps the
  242. function of force opening locked records with a different lgkey than
  243. yours. Please don't be confused by the two kinds of locks. The lgkey
  244. lock is a word lock where a field in the record ties that record to
  245. you and only you. The network mode lock lets multi-users share and
  246. edit the SAME record without contention or corruption.
  247.  
  248.  
  249.  
  250. Logger was written by me with toolboxes from Max Software Consultants
  251. at 301/828-5935 for handling the dbase structures and Turbo Power at
  252. 408/438-8608 for tsr/swapping/string/memo handling.
  253.  
  254.  
  255. At where I work, we run Artisoft's Lantastic AI Netbios/NOS on Western
  256. Digital and Artisoft ethernet cards. We have our data sitting on the
  257. server in an area 'K:\LOGGER3\L3GF.DBF'.  I have my neton batch file
  258. set up the environment variables, 'set lgkey=Lonnie Rolland'.
  259.  
  260. Note you may need to expand your environment size beyond the default
  261. 160 bytes by placing the following in your config.sys file.
  262. 'shell c:\command.com c:\ /e:256 /p'
  263.  
  264. I will not be held responsible for your data loss or your hardware
  265. acting up. I am a Senior Tech Support Engineer. I created this program
  266. (AT HOME, LATE AT NIGHT) to maintain many odd databases at work.
  267.  
  268.  
  269. * * * * * * * KNOWN BUG LIST: * * * * * * *
  270. ( I thought that would get your attention.)
  271.  
  272. 1) You will get a toolbox '540' error if you are running in the network
  273.    mode and share is not loaded and resident.
  274.  
  275. 2) You will get a dos error '2' when logger fails to find and open the
  276.    data files. The set command can say you have data files in a subdir and
  277.    you forgot to put them there.
  278.  
  279. 3) If the printer is not available or on-line, logger properly detects
  280.    that its off-line. Logger will not post a "PRINTER OFF-LINE" message
  281.    but instead will completely ignore the printer's absence and go on
  282.    with its business.
  283.  
  284. 4) If there is no LIM 4.0 / EMS ram available, the tsr version of logger
  285.    will make a 'SWAP' file to the root directory of the 'C:' drive only.
  286.    But fear not. When you release the tsr, it removes the swap file.
  287.    If you kill power and not release the tsr first, when you next power
  288.    up, the swap file will still be there. Note the swap file's attribute
  289.    makes it hidden from view.
  290.  
  291. 5) It cannot (yet) have multible records started and multible timers timing
  292.    at the same time. Do you (really) get three phone calls in a row then work
  293.    on all three simultaineously? Sorry, you have to close ( if only tempor-
  294.    arily ) the first call/log to start up the second.
  295.  
  296.  
  297. I want your feedback!  Call my company BBS and drop me a note.  It's number
  298. is (714) 549-6669.  The modem is 12/24/9600 baud, eight data bits, no
  299. parity, one stop bit.  Its open access to everybody.  The latest version of
  300. the program will be posted there.  If you're feeling a little guilty about
  301. not paying for the Logger programs, please (by all means) send money!
  302. I have been making changes (for what seems) forever on this thing.  Thank
  303. goodness my mate is tolerant of me sitting back here night after night.
  304.  
  305. If you were using one of my older programs of several years ago (Logger3),
  306. please note we moved to a new building and I had to (UGGH!) get a new BBS
  307. phone number.
  308.  
  309. <relax & enjoy>
  310.  
  311. (my work) => Symbol Technologies, 340 Fischer Ave, Costa Mesa, CA. 92626
  312. (my home) => 22612 Napoli Street, Laguna Hills, Ca. 92653
  313.  
  314. (c) Copyright 1992, Lonnie J. Rolland
  315. dBASE and dBASE III+ is a registered trademarks of Borland Int.
  316.